<!DOCTYPE html>
<!-- saved from url=(0035)http://geek.itheima.net/api-pc.html -->
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>极客园PC</title>
      
      <style>@charset "UTF-8";
html,
body,
h1,
h2,
h3,
h4,
h5,
h6,
p,
blockquote {
  margin: 0;
  padding: 0;
  font-weight: normal;
  -webkit-font-smoothing: antialiased;
}

/* 设置滚动条的样式 */
::-webkit-scrollbar {
  width: 6px;
}

/* 外层轨道 */
::-webkit-scrollbar-track {
  -webkit-box-shadow: inset006pxrgba(255, 0, 0, 0.3);
  background: rgba(0, 0, 0, 0.1);
}

/* 滚动条滑块 */
::-webkit-scrollbar-thumb {
  border-radius: 4px;
  background: rgba(0, 0, 0, 0.2);
  -webkit-box-shadow: inset006pxrgba(0, 0, 0, 0.5);
}

::-webkit-scrollbar-thumb:window-inactive {
  background: rgba(0, 0, 0, 0.2);
}

body {
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", SimSun, sans-serif;
  font-size: 13px;
  line-height: 25px;
  color: #393838;
  position: relative;
}

table {
  margin: 10px 0 15px 0;
  border-collapse: collapse;
}

td,
th {
  border: 1px solid #ddd;
  padding: 3px 10px;
}

th {
  padding: 5px 10px;
}

a, a:link, a:visited {
  color: #34495e;
  text-decoration: none;
}

a:hover, a:focus {
  color: #59d69d;
  text-decoration: none;
}

a img {
  border: none;
}

p {
  padding-left: 10px;
  margin-bottom: 9px;
}

h1,
h2,
h3,
h4,
h5,
h6 {
  color: #404040;
  line-height: 36px;
}

h1 {
  color: #2c3e50;
  font-weight: 600;
  margin-bottom: 16px;
  font-size: 32px;
  padding-bottom: 16px;
  border-bottom: 1px solid #ddd;
  line-height: 50px;
}

h2 {
  font-size: 28px;
  padding-top: 10px;
  padding-bottom: 10px;
}

h3 {
  clear: both;
  font-weight: 400;
  margin-top: 20px;
  margin-bottom: 20px;
  border-left: 3px solid #59d69d;
  padding-left: 8px;
  font-size: 18px;
}

h4 {
  font-size: 16px;
}

h5 {
  font-size: 14px;
}

h6 {
  font-size: 13px;
}

hr {
  margin: 0 0 19px;
  border: 0;
  border-bottom: 1px solid #ccc;
}

blockquote {
  padding: 13px 13px 21px 15px;
  margin-bottom: 18px;
  font-family: georgia, serif;
  font-style: italic;
}

blockquote:before {
  font-size: 40px;
  margin-left: -10px;
  font-family: georgia, serif;
  color: #eee;
}

blockquote p {
  font-size: 14px;
  font-weight: 300;
  line-height: 18px;
  margin-bottom: 0;
  font-style: italic;
}

code,
pre {
  font-family: Monaco, Andale Mono, Courier New, monospace;
}

code {
  background-color: #fee9cc;
  color: rgba(0, 0, 0, 0.75);
  padding: 1px 3px;
  font-size: 12px;
  -webkit-border-radius: 3px;
  -moz-border-radius: 3px;
  border-radius: 3px;
}

pre {
  display: block;
  padding: 14px;
  margin: 0 0 18px;
  line-height: 16px;
  font-size: 11px;
  border: 1px solid #d9d9d9;
  white-space: pre-wrap;
  word-wrap: break-word;
  background: #f6f6f6;
}

pre code {
  background-color: #f6f6f6;
  color: #737373;
  font-size: 11px;
  padding: 0;
}

sup {
  font-size: 0.83em;
  vertical-align: super;
  line-height: 0;
}

* {
  -webkit-print-color-adjust: exact;
}

@media print {
  body,
  code,
  pre code,
  h1,
  h2,
  h3,
  h4,
  h5,
  h6 {
    color: black;
  }

  table,
  pre {
    page-break-inside: avoid;
  }
}
html,
body {
  height: 100%;
}

.table-of-contents {
  position: fixed;
  top: 61px;
  left: 0;
  bottom: 0;
  overflow-x: hidden;
  overflow-y: auto;
  width: 260px;
}

.table-of-contents > ul > li > a {
  font-size: 20px;
  margin-bottom: 16px;
  margin-top: 16px;
}

.table-of-contents ul {
  overflow: auto;
  margin: 0px;
  height: 100%;
  padding: 0px 0px;
  box-sizing: border-box;
  list-style-type: none;
}

.table-of-contents ul li {
  padding-left: 20px;
}

.table-of-contents a {
  padding: 2px 0px;
  display: block;
  text-decoration: none;
}

.content-right {
  max-width: 700px;
  margin-left: 290px;
  padding-left: 70px;
  flex-grow: 1;
}
.content-right h2:target {
  padding-top: 80px;
}

body > p {
  margin-left: 30px;
}

body > table {
  margin-left: 30px;
}

body > pre {
  margin-left: 30px;
}

.curProject {
  position: fixed;
  top: 20px;
  font-size: 25px;
  color: black;
  margin-left: -240px;
  width: 240px;
  padding: 5px;
  line-height: 25px;
  box-sizing: border-box;
}

.g-doc {
  margin-top: 56px;
  padding-top: 24px;
  display: flex;
}

.curproject-name {
  font-size: 42px;
}

.m-header {
  background: #32363a;
  height: 56px;
  line-height: 56px;
  padding-left: 60px;
  display: flex;
  align-items: center;
  position: fixed;
  z-index: 9;
  top: 0;
  left: 0;
  right: 0;
}
.m-header .title {
  font-size: 22px;
  color: #fff;
  font-weight: normal;
  -webkit-font-smoothing: antialiased;
  margin: 0;
  margin-left: 16px;
  padding: 0;
  line-height: 56px;
  border: none;
}
.m-header .nav {
  color: #fff;
  font-size: 16px;
  position: absolute;
  right: 32px;
  top: 0;
}
.m-header .nav a {
  color: #fff;
  margin-left: 16px;
  padding: 8px;
  transition: color .2s;
}
.m-header .nav a:hover {
  color: #59d69d;
}

.m-footer {
  border-top: 1px solid #ddd;
  padding-top: 16px;
  padding-bottom: 16px;
}

/*# sourceMappingURL=defaultTheme.css.map */
</style>
      </head>
      <body cz-shortcut-listen="true">
        <div class="m-header">
          <a href="http://geek.itheima.net/api-pc.html#" style="display: inherit;"><svg class="svg" width="32px" height="32px" viewBox="0 0 64 64" version="1.1"><title>Icon</title><desc>Created with Sketch.</desc><defs><lineargradient x1="50%" y1="0%" x2="50%" y2="100%" id="linearGradient-1"><stop stop-color="#FFFFFF" offset="0%"></stop><stop stop-color="#F2F2F2" offset="100%"></stop></lineargradient><circle id="path-2" cx="31.9988602" cy="31.9988602" r="2.92886048"></circle><filter x="-85.4%" y="-68.3%" width="270.7%" height="270.7%" filterUnits="objectBoundingBox" id="filter-3"><feoffset dx="0" dy="1" in="SourceAlpha" result="shadowOffsetOuter1"></feoffset><fegaussianblur stdDeviation="1.5" in="shadowOffsetOuter1" result="shadowBlurOuter1"></fegaussianblur><fecolormatrix values="0 0 0 0 0   0 0 0 0 0   0 0 0 0 0  0 0 0 0.159703351 0" type="matrix" in="shadowBlurOuter1"></fecolormatrix></filter></defs><g id="首页" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd"><g id="大屏幕"><g id="Icon"><circle id="Oval-1" fill="url(#linearGradient-1)" cx="32" cy="32" r="32"></circle><path d="M36.7078009,31.8054514 L36.7078009,51.7110548 C36.7078009,54.2844537 34.6258634,56.3695395 32.0579205,56.3695395 C29.4899777,56.3695395 27.4099998,54.0704461 27.4099998,51.7941246 L27.4099998,31.8061972 C27.4099998,29.528395 29.4909575,27.218453 32.0589004,27.230043 C34.6268432,27.241633 36.7078009,29.528395 36.7078009,31.8054514 Z" id="blue" fill="#2359F1" fill-rule="nonzero"></path><path d="M45.2586091,17.1026914 C45.2586091,17.1026914 45.5657231,34.0524383 45.2345291,37.01141 C44.9033351,39.9703817 43.1767091,41.6667796 40.6088126,41.6667796 C38.040916,41.6667796 35.9609757,39.3676862 35.9609757,37.0913646 L35.9609757,17.1034372 C35.9609757,14.825635 38.0418959,12.515693 40.6097924,12.527283 C43.177689,12.538873 45.2586091,14.825635 45.2586091,17.1026914 Z" id="green" fill="#57CF27" fill-rule="nonzero" transform="translate(40.674608, 27.097010) rotate(60.000000) translate(-40.674608, -27.097010) "></path><path d="M28.0410158,17.0465598 L28.0410158,36.9521632 C28.0410158,39.525562 25.9591158,41.6106479 23.3912193,41.6106479 C20.8233227,41.6106479 18.7433824,39.3115545 18.7433824,37.035233 L18.7433824,17.0473055 C18.7433824,14.7695034 20.8243026,12.4595614 23.3921991,12.4711513 C25.9600956,12.4827413 28.0410158,14.7695034 28.0410158,17.0465598 Z" id="red" fill="#FF561B" fill-rule="nonzero" transform="translate(23.392199, 27.040878) rotate(-60.000000) translate(-23.392199, -27.040878) "></path><g id="inner-round"><use fill="black" fill-opacity="1" filter="url(#filter-3)" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#path-2"></use><use fill="#F7F7F7" fill-rule="evenodd" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#path-2"></use></g></g></g></g></svg></a>
          <a href="http://geek.itheima.net/api-pc.html#"><h1 class="title">YAPI 接口文档</h1></a>
          <div class="nav">
            <a href="https://yapi.ymfe.org/">YApi</a>
          </div>
        </div>
        <div class="g-doc">
          <div class="table-of-contents"><ul><li><a href="http://geek.itheima.net/api-pc.html#u6587u7ae0u7ba1u7406">文章管理</a><ul><li><a href="http://geek.itheima.net/api-pc.html#u5220u9664u6587u7ae00a3ca20id3du5220u9664u6587u7ae03e203ca3e">删除文章
</a><a id="删除文章"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u53d1u8868u6587u7ae00a3ca20id3du53d1u8868u6587u7ae03e203ca3e">发表文章
</a><a id="发表文章"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u7f16u8f91u6587u7ae00a3ca20id3du7f16u8f91u6587u7ae03e203ca3e">编辑文章
</a><a id="编辑文章"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u6587u7ae0u5217u88680a3ca20id3du83b7u53d6u6587u7ae0u5217u88683e203ca3e">获取文章列表
</a><a id="获取文章列表"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u6587u7ae0u8be6u60c50a3ca20id3du83b7u53d6u6587u7ae0u8be6u60c53e203ca3e">获取文章详情
</a><a id="获取文章详情"> </a></li></ul></li><li><a href="http://geek.itheima.net/api-pc.html#u7528u6237">用户</a><ul><li><a href="http://geek.itheima.net/api-pc.html#u53d1u9001u77edu4fe1u9a8cu8bc1u78010a3ca20id3du53d1u9001u77edu4fe1u9a8cu8bc1u78013e203ca3e">发送短信验证码
</a><a id="发送短信验证码"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u7528u6237u8ba4u8bc1uff08u767bu5f55u6ce8u518cuff090a3ca20id3du7528u6237u8ba4u8bc1uff08u767bu5f55u6ce8u518cuff093e203ca3e">用户认证（登录注册）
</a><a id="用户认证（登录注册）"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u7f16u8f91u7528u6237u4e2au4ebau8d44u65990a3ca20id3du7f16u8f91u7528u6237u4e2au4ebau8d44u65993e203ca3e">编辑用户个人资料
</a><a id="编辑用户个人资料"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u7f16u8f91u7528u6237u7167u7247u8d44u6599uff08u5934u50cfu3001u8eabu4efdu8bc1u7167u7247uff090a3ca20id3du7f16u8f91u7528u6237u7167u7247u8d44u6599uff08u5934u50cfu3001u8eabu4efdu8bc1u7167u7247uff093e203ca3e">编辑用户照片资料（头像、身份证照片）
</a><a id="编辑用户照片资料（头像、身份证照片）"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u7528u6237u4e2au4ebau8d44u65990a3ca20id3du83b7u53d6u7528u6237u4e2au4ebau8d44u65993e203ca3e">获取用户个人资料
</a><a id="获取用户个人资料"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u7528u6237u7684u5173u6ce8u5217u88680a3ca20id3du83b7u53d6u7528u6237u7684u5173u6ce8u5217u88683e203ca3e">获取用户的关注列表
</a><a id="获取用户的关注列表"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u7528u6237u7684u7c89u4e1du5217u88680a3ca20id3du83b7u53d6u7528u6237u7684u7c89u4e1du5217u88683e203ca3e">获取用户的粉丝列表
</a><a id="获取用户的粉丝列表"> </a></li><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u7528u6237u81eau5df1u4fe1u606f0a3ca20id3du83b7u53d6u7528u6237u81eau5df1u4fe1u606f3e203ca3e">获取用户自己信息
</a><a id="获取用户自己信息"> </a></li></ul></li><li><a href="http://geek.itheima.net/api-pc.html#u9891u9053">频道</a><ul><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u6240u6709u9891u9053u5217u88680a3ca20id3du83b7u53d6u6240u6709u9891u9053u5217u88683e203ca3e">获取所有频道列表
</a><a id="获取所有频道列表"> </a></li></ul></li><li><a href="http://geek.itheima.net/api-pc.html#u8bc4u8bba">评论</a><ul><li><a href="http://geek.itheima.net/api-pc.html#u83b7u53d6u8bc4u8bbau6216u8bc4u8bbau56deu590d0a3ca20id3du83b7u53d6u8bc4u8bbau6216u8bc4u8bbau56deu590d3e203ca3e">获取评论或评论回复
</a><a id="获取评论或评论回复"> </a></li></ul></li><li><a href="http://geek.itheima.net/api-pc.html#u6587u4ef6">文件</a><ul><li><a href="http://geek.itheima.net/api-pc.html#u4e0au4f20u56feu72470a3ca20id3du4e0au4f20u56feu72473e203ca3e">上传图片
</a><a id="上传图片"> </a></li></ul></li></ul></div>
          <div id="right" class="content-right">
           <h1 class="curproject-name"> 极客园PC </h1> 
<h1 id="u6587u7ae0u7ba1u7406">文章管理</h1>
<p></p>
<h2 id="u5220u9664u6587u7ae00a3ca20id3du5220u9664u6587u7ae03e203ca3e">删除文章
<a id="删除文章"> </a></h2>
<p></p>
<h3 id="">基本信息</h3>
<p><strong>Path：</strong> /v1_0/mp/articles/:target</p>
<p><strong>Method：</strong> DELETE</p>
<p><strong>接口描述：</strong></p>
<p><strong>1. 201 OK</strong><br>
<span class="colour" style="color:rgb(51, 51, 51)">2. 400 请求参数错误</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">3.&nbsp; 401 token过期或未传~~~~</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">4. 507 服务器数据库异常</span></p>
<p><br data-tomark-pass=""><br>
<br data-tomark-pass=""><br>
特别注意： 不允许直接删除 已正式发表的文章，如想删除，需要先编辑，将其变为待审核或者草稿才可以删除</p>
<h3 id="-2">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>application/json</td>
<td>是</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td></td>
<td>用户token</td>
</tr>
</tbody>
</table>
<p><strong>路径参数</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>target</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>draft</td>
<td>否</td>
<td>true</td>
<td>是否存为草稿，true是 false否</td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody">
               </tbody>
              </table>
<h3 id="-3">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody">
               </tbody>
              </table>
<h2 id="u53d1u8868u6587u7ae00a3ca20id3du53d1u8868u6587u7ae03e203ca3e">发表文章
<a id="发表文章"> </a></h2>
<p></p>
<h3 id="-4">基本信息</h3>
<p><strong>Path：</strong> /v1_0/mp/articles</p>
<p><strong>Method：</strong> POST</p>
<p><strong>接口描述：</strong></p>
<p><strong>1. 201 OK</strong><br>
<span class="colour" style="color:rgb(51, 51, 51)">2. 400 请求参数错误</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">3.&nbsp; 401 token过期或未传~~~~</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">4. 507 服务器数据库异常</span></p>
<p>请求参数cover 中 传递样例为&nbsp; &nbsp;{ type: 0, images: []&nbsp; }（无图）&nbsp;{ type: 1, images: [“地址1”]&nbsp; }（单图）&nbsp;&nbsp;{ type: 3, images: [“地址1”，‘地址2’，‘地址3’]&nbsp; }<br>
特别注意：&nbsp; 如果发表为正式文章，文章的状态会首先变为 待审核状态，即status为1,1分钟后系统会自动审核通过，状态成为审核通过，status为2，审核失败状态一般不存在</p>
<h3 id="-5">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>application/json</td>
<td>是</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td></td>
<td>用户token</td>
</tr>
</tbody>
</table>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>draft</td>
<td>否</td>
<td>true</td>
<td>是否存为草稿，true是 false否</td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> title</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章标题</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> content</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章内容</span></td><td key="5"></td></tr><tr key="0-2"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> cover</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-2-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> type</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面类型 -1:自动，0-无图，1-1张，3-3张</span></td><td key="5"></td></tr><tr key="0-2-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> images</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">item 类型: string</span></td><td key="5"></td></tr><tr key="0-3"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> channel_id</span></td><td key="1"><span>number</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章所属频道id</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h3 id="-6">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-0-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章id</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u7f16u8f91u6587u7ae00a3ca20id3du7f16u8f91u6587u7ae03e203ca3e">编辑文章
<a id="编辑文章"> </a></h2>
<p></p>
<h3 id="-7">基本信息</h3>
<p><strong>Path：</strong> /v1_0/mp/articles/:target</p>
<p><strong>Method：</strong> PUT</p>
<p><strong>接口描述：</strong></p>
<p><strong>1. 201 OK</strong><br>
<span class="colour" style="color:rgb(51, 51, 51)">2. 400 请求参数错误</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">3.&nbsp; 401 token过期或未传~~~~</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">4. 507 服务器数据库异常</span></p>
<p>请求参数cover 中 传递样例为&nbsp; &nbsp;{ type: 0, images: []&nbsp; }（无图）&nbsp;{ type: 1, images: [“地址1”]&nbsp; }（单图）&nbsp;&nbsp;{ type: 3, images: [“地址1”，‘地址2’，‘地址3’]&nbsp; }</p>
<p>特别注意：&nbsp; 如果发表为正式文章，文章的状态会首先变为 待审核状态，即status为1,1分钟后系统会自动审核通过，状态成为审核通过，status为2，审核失败状态一般不存在</p>
<h3 id="-8">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>application/json</td>
<td>是</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td></td>
<td>用户token</td>
</tr>
</tbody>
</table>
<p><strong>路径参数</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>target</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>draft</td>
<td>否</td>
<td>true</td>
<td>是否存为草稿，true是 false否</td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> title</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章标题</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> content</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章内容</span></td><td key="5"></td></tr><tr key="0-2"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> cover</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-2-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> type</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面类型 -1:自动，0-无图，1-1张，3-3张</span></td><td key="5"></td></tr><tr key="0-2-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> images</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">item 类型: string</span></td><td key="5"></td></tr><tr key="0-3"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> channel_id</span></td><td key="1"><span>number</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章所属频道id</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h3 id="-9">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-0-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章id</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u83b7u53d6u6587u7ae0u5217u88680a3ca20id3du83b7u53d6u6587u7ae0u5217u88683e203ca3e">获取文章列表
<a id="获取文章列表"> </a></h2>
<p></p>
<h3 id="-10">基本信息</h3>
<p><strong>Path：</strong> /v1_0/mp/articles</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<p><strong>1. 200 OK</strong><br>
<span class="colour" style="color:rgb(51, 51, 51)">2. 400 请求参数错误</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">3. 401&nbsp;</span><span class="colour" style="color:rgb(85, 85, 85)">token过期或未传~~~~</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">4. 507 服务器数据库异常</span></p>
<h3 id="-11">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td></td>
<td>用户令牌 token</td>
</tr>
</tbody>
</table>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>status</td>
<td>否</td>
<td></td>
<td>文章状态，0-草稿，1-待审核，2-审核通过，3-审核失败，不传为全部</td>
</tr>
<tr>
<td>channel_id</td>
<td>是</td>
<td></td>
<td>不传为全部</td>
</tr>
<tr>
<td>begin_pubdate</td>
<td>否</td>
<td></td>
<td>起始时间</td>
</tr>
<tr>
<td>end_pubdate</td>
<td>否</td>
<td></td>
<td>截止时间</td>
</tr>
<tr>
<td>page</td>
<td>否</td>
<td></td>
<td>页码 默认为1页</td>
</tr>
<tr>
<td>per_page</td>
<td>否</td>
<td></td>
<td>每页数量 不传为默认10</td>
</tr>
</tbody>
</table>
<h3 id="-12">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-0-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> page</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">当前页数	</span></td><td key="5"></td></tr><tr key="0-0-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> per_page</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">每页数量	</span></td><td key="5"></td></tr><tr key="0-0-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> results</span></td><td key="1"><span>object []</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"><p key="3"><span style="font-weight: &#39;700&#39;">item 类型: </span><span>object</span></p></td></tr><tr key="0-0-2-0"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章id	</span></td><td key="5"></td></tr><tr key="0-0-2-1"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> title</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章标题	</span></td><td key="5"></td></tr><tr key="0-0-2-2"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> status</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章状态</span></td><td key="5"></td></tr><tr key="0-0-2-3"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> comment_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">评论数量	</span></td><td key="5"></td></tr><tr key="0-0-2-4"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> pubdate</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">发布时间	</span></td><td key="5"></td></tr><tr key="0-0-2-5"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> cover</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面</span></td><td key="5"></td></tr><tr key="0-0-2-5-0"><td key="0"><span style="padding-left: 60px"><span style="color: #8c8a8a">├─</span> type</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面类型，0-无封面，1-1张封面图片，3-3张封面	</span></td><td key="5"></td></tr><tr key="0-0-2-5-1"><td key="0"><span style="padding-left: 60px"><span style="color: #8c8a8a">├─</span> images</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面图片	</span></td><td key="5"></td></tr><tr key="0-0-2-6"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> like_count</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">点赞数	</span></td><td key="5"></td></tr><tr key="0-0-2-7"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> read_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">阅读数</span></td><td key="5"></td></tr><tr key="0-0-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> total_count</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章总数	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u83b7u53d6u6587u7ae0u8be6u60c50a3ca20id3du83b7u53d6u6587u7ae0u8be6u60c53e203ca3e">获取文章详情
<a id="获取文章详情"> </a></h2>
<p></p>
<h3 id="-13">基本信息</h3>
<p><strong>Path：</strong> /v1_0/mp/articles/:target</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<p><strong>1. 201 OK</strong><br>
<span class="colour" style="color:rgb(51, 51, 51)">2. 400 请求参数错误</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">3.&nbsp; 401 token过期或未传~~~~</span><br>
<span class="colour" style="color:rgb(51, 51, 51)">4. 507 服务器数据库异常</span></p>
<p>请求参数cover 中 传递样例为&nbsp; &nbsp;{ type: 0, images: []&nbsp; }（无图）&nbsp;{ type: 1, images: [“地址1”]&nbsp; }（单图）&nbsp;&nbsp;{ type: 3, images: [“地址1”，‘地址2’，‘地址3’]&nbsp; }<br>
特别注意：&nbsp; 如果发表为正式文章，文章的状态会首先变为 待审核状态，即status为1,1分钟后系统会自动审核通过，状态成为审核通过，status为2，审核失败状态一般不存在</p>
<h3 id="-14">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>application/json</td>
<td>是</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td></td>
<td>用户token</td>
</tr>
</tbody>
</table>
<p><strong>路径参数</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>target</td>
<td></td>
<td>文章id</td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> title</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章标题</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> content</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章内容</span></td><td key="5"></td></tr><tr key="0-2"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> cover</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-2-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> type</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面类型 -1:自动，0-无图，1-1张，3-3张</span></td><td key="5"></td></tr><tr key="0-2-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> images</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">item 类型: string</span></td><td key="5"></td></tr><tr key="0-3"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> channel_id</span></td><td key="1"><span>number</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章所属频道id</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h3 id="-15">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-0-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章id</span></td><td key="5"></td></tr><tr key="0-0-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> title</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">标题</span></td><td key="5"></td></tr><tr key="0-0-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> channel_id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">频道id</span></td><td key="5"></td></tr><tr key="0-0-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> content</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">文章内容</span></td><td key="5"></td></tr><tr key="0-0-4"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> cover</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面</span></td><td key="5"></td></tr><tr key="0-0-4-0"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> type</span></td><td key="1"><span>number</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面类型 0-无图，1-单图，3-三图</span></td><td key="5"></td></tr><tr key="0-0-4-1"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> images</span></td><td key="1"><span>string []</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">封面图片地址数组</span></td><td key="5"><p key="3"><span style="font-weight: &#39;700&#39;">item 类型: </span><span>string</span></p></td></tr><tr key="array-11055"><td key="0"><span style="padding-left: 60px"><span style="color: #8c8a8a">├─</span> </span></td><td key="1"><span></span></td><td key="2">非必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h1 id="u7528u6237">用户</h1>
<p></p>
<h2 id="u53d1u9001u77edu4fe1u9a8cu8bc1u78010a3ca20id3du53d1u9001u77edu4fe1u9a8cu8bc1u78013e203ca3e">发送短信验证码
<a id="发送短信验证码"> </a></h2>
<p></p>
<h3 id="-16">基本信息</h3>
<p><strong>Path：</strong> /v1_0/sms/codes/:mobile</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<p>1 线上接口路径<br>
<span class="colour" style="color: rgb(57, 56, 56);"><a href="http://localhost:8000/app/v1_0/sms/codes/:mobile">http://localhost:8000/v1_0/sms/codes/:mobile</a></span></p>
<h4>2 接口访问次数受限</h4>
<pre><code>每手机号每分钟1次
</code></pre>
<h4>3 返回HTTP状态码</h4>
<ol>
<li>200 OK</li>
<li>404 手机号不正确</li>
<li>429 接口访问次数受限 ， body数据返回</li>
</ol>
<pre><code data-language="json" class="lang-json">{
   "message": "Too many requests."
}
</code></pre>
<ol>
<li>507 服务器数据库异常</li>
</ol>
<h3 id="-17">请求参数</h3>
<p><strong>路径参数</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>mobile</td>
<td>18612345678</td>
<td>手机号</td>
</tr>
</tbody>
</table>
<h3 id="-18">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u7528u6237u8ba4u8bc1uff08u767bu5f55u6ce8u518cuff090a3ca20id3du7528u6237u8ba4u8bc1uff08u767bu5f55u6ce8u518cuff093e203ca3e">用户认证（登录注册）
<a id="用户认证（登录注册）"> </a></h2>
<p></p>
<h3 id="-19">基本信息</h3>
<p><strong>Path：</strong> /v1_0/authorizations</p>
<p><strong>Method：</strong> POST</p>
<p><strong>接口描述：</strong></p>
<p>1. 线上地址<br>
<span class="colour" style="color:rgb(57, 56, 56)"><a href="http://localhost:8000/app/v1_0/authorizations">http://localhost:8000/v1_0/authorizations</a></span></p>
<h3>2.&nbsp; 返回HTTP状态码</h3>
<p><strong>1. 201 OK</strong><br>
2. 400 请求参数错误<br>
&nbsp; &nbsp; &nbsp; &nbsp; 包括：参数缺失、手机号格式不正确、验证码失效等<br>
3. 507 服务器数据库异常</p>
<h3>3. token说明</h3>
<ol>
<li><code data-backticks="1">token</code>用于访问需要身份认证的普通接口，有效期2小时</li>
<li><code data-backticks="1">refresh_token</code>&nbsp;用于在token过期后，获取新的用户token，有效期14天</li>
</ol>
<h3 id="-20">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>application/json</td>
<td>是</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> mobile</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">手机号	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> code</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">短信验证码	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h3 id="-21">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> token</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户token令牌	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> refresh_token</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用于刷新token的令牌	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u7f16u8f91u7528u6237u4e2au4ebau8d44u65990a3ca20id3du7f16u8f91u7528u6237u4e2au4ebau8d44u65993e203ca3e">编辑用户个人资料
<a id="编辑用户个人资料"> </a></h2>
<p></p>
<h3 id="-22">基本信息</h3>
<p><strong>Path：</strong> /v1_0/user/profile</p>
<p><strong>Method：</strong> PATCH</p>
<p><strong>接口描述：</strong></p>
<p>1 线上地址</p>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/user/profile
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>401 用户未认证</li>
<li>507 数据库错误, 图片保存失败</li>
<li><strong>200 OK</strong></li>
</ul>
<h3>3 请求的字段参数 发送几个保存几个，不发送的不修改</h3>
<h3>请求参数</h3>
<h3 id="-23">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>application/json</td>
<td>是</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td>
<td>用户令牌token<br></td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">昵称</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> gender</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">性别，0-男，1-女	</span></td><td key="5"></td></tr><tr key="0-2"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> birthday</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">生日，格式'2018-12-20'	</span></td><td key="5"></td></tr><tr key="0-3"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> real_name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">真实姓名</span></td><td key="5"></td></tr><tr key="0-4"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> intro</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">个人介绍</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h3 id="-24">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户id	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户名	</span></td><td key="5"></td></tr><tr key="0-1-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">头像url地址	</span></td><td key="5"></td></tr><tr key="0-1-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> gender</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">性别，0-男，1-女	</span></td><td key="5"></td></tr><tr key="0-1-4"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> birthday</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">生日，格式 '2018-12-20'	</span></td><td key="5"></td></tr><tr key="0-1-5"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> real_name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">真实用户名	</span></td><td key="5"></td></tr><tr key="0-1-6"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> intro</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">个人介绍	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u7f16u8f91u7528u6237u7167u7247u8d44u6599uff08u5934u50cfu3001u8eabu4efdu8bc1u7167u7247uff090a3ca20id3du7f16u8f91u7528u6237u7167u7247u8d44u6599uff08u5934u50cfu3001u8eabu4efdu8bc1u7167u7247uff093e203ca3e">编辑用户照片资料（头像、身份证照片）
<a id="编辑用户照片资料（头像、身份证照片）"> </a></h2>
<p></p>
<h3 id="-25">基本信息</h3>
<p><strong>Path：</strong> /v1_0/user/photo</p>
<p><strong>Method：</strong> PATCH</p>
<p><strong>接口描述：</strong></p>
<ul>
<li>1 线上地址</li>
</ul>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/user/photo
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>401 用户未认证</li>
<li>507 数据库错误, 图片保存失败</li>
<li><strong>200 OK</strong></li>
</ul>
<h3>3 请求的字段参数 发送几个保存几个，不发送的不修改</h3>
<h3 id="-26">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>multipart/form-data</td>
<td>是</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td>
<td>用户令牌token</td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数类型</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>photo</td>
<td>file</td>
<td>否</td>
<td></td>
<td>头像</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<h3 id="-27">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span>  id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户id	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">头像url地址	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u83b7u53d6u7528u6237u4e2au4ebau8d44u65990a3ca20id3du83b7u53d6u7528u6237u4e2au4ebau8d44u65993e203ca3e">获取用户个人资料
<a id="获取用户个人资料"> </a></h2>
<p></p>
<h3 id="-28">基本信息</h3>
<p><strong>Path：</strong> /v1_0/user/profile</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<ul>
<li>1 线上地址</li>
</ul>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/user/profile
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>401 用户未认证</li>
<li>507 数据库错误</li>
<li><strong>200 OK</strong></li>
</ul>
<h3 id="-29">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td>
<td>用户令牌token<br></td>
</tr>
</tbody>
</table>
<h3 id="-30">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户id	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户名	</span></td><td key="5"></td></tr><tr key="0-1-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">头像	</span></td><td key="5"></td></tr><tr key="0-1-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> mobile</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">手机号	</span></td><td key="5"></td></tr><tr key="0-1-4"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> gender</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">性别，0-男，1-女	</span></td><td key="5"></td></tr><tr key="0-1-5"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> birthday</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">生日，格式 '2018-12-20'	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u83b7u53d6u7528u6237u7684u5173u6ce8u5217u88680a3ca20id3du83b7u53d6u7528u6237u7684u5173u6ce8u5217u88683e203ca3e">获取用户的关注列表
<a id="获取用户的关注列表"> </a></h2>
<p></p>
<h3 id="-31">基本信息</h3>
<p><strong>Path：</strong> /v1_0/user/followings</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<p>1 线上地址</p>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/user/followings
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>401 用户未认证</li>
<li>507 数据库错误</li>
<li><strong>200 OK</strong></li>
</ul>
<h3 id="-32">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td>
<td>用户令牌token<br></td>
</tr>
</tbody>
</table>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>page</td>
<td>是</td>
<td></td>
<td>页数<br></td>
</tr>
<tr>
<td>per_page</td>
<td>是</td>
<td></td>
<td>每页数量<br></td>
</tr>
</tbody>
</table>
<h3 id="-33">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> total_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">所有关注的用户总数	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> page</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">当前页数	</span></td><td key="5"></td></tr><tr key="0-1-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> per_page</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">每页数量	</span></td><td key="5"></td></tr><tr key="0-1-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> results</span></td><td key="1"><span>object []</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"><p key="3"><span style="font-weight: &#39;700&#39;">item 类型: </span><span>object</span></p></td></tr><tr key="0-1-3-0"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">关注的用户id	</span></td><td key="5"></td></tr><tr key="0-1-3-1"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">关注的用户名	</span></td><td key="5"></td></tr><tr key="0-1-3-2"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">头像	</span></td><td key="5"></td></tr><tr key="0-1-3-3"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> fans_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">粉丝数	</span></td><td key="5"></td></tr><tr key="0-1-3-4"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> mutual_follow</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">是否互相关注	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u83b7u53d6u7528u6237u7684u7c89u4e1du5217u88680a3ca20id3du83b7u53d6u7528u6237u7684u7c89u4e1du5217u88683e203ca3e">获取用户的粉丝列表
<a id="获取用户的粉丝列表"> </a></h2>
<p></p>
<h3 id="-34">基本信息</h3>
<p><strong>Path：</strong> /v1_0/user/followers</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<p>1 线上地址</p>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/user/followings
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>401 用户未认证</li>
<li>507 数据库错误</li>
<li><strong>200 OK</strong></li>
</ul>
<h3 id="-35">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td>
<td>用户令牌token<br></td>
</tr>
</tbody>
</table>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>page</td>
<td>否</td>
<td></td>
<td>页数<br></td>
</tr>
<tr>
<td>per_page</td>
<td>否</td>
<td></td>
<td>每页数量<br></td>
</tr>
</tbody>
</table>
<h3 id="-36">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> total_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">所有关注的用户总数	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> page</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">当前页数	</span></td><td key="5"></td></tr><tr key="0-1-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> per_page</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">每页数量	</span></td><td key="5"></td></tr><tr key="0-1-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> results</span></td><td key="1"><span>object []</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"><p key="3"><span style="font-weight: &#39;700&#39;">item 类型: </span><span>object</span></p></td></tr><tr key="0-1-3-0"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">关注的用户id	</span></td><td key="5"></td></tr><tr key="0-1-3-1"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">关注的用户名	</span></td><td key="5"></td></tr><tr key="0-1-3-2"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">头像	</span></td><td key="5"></td></tr><tr key="0-1-3-3"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> fans_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">粉丝数	</span></td><td key="5"></td></tr><tr key="0-1-3-4"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> mutual_follow</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">是否互相关注	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h2 id="u83b7u53d6u7528u6237u81eau5df1u4fe1u606f0a3ca20id3du83b7u53d6u7528u6237u81eau5df1u4fe1u606f3e203ca3e">获取用户自己信息
<a id="获取用户自己信息"> </a></h2>
<p></p>
<h3 id="-37">基本信息</h3>
<p><strong>Path：</strong> /v1_0/user</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<p>1 线上地址</p>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/user
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>401 用户认证失败</li>
<li>507 数据库错误</li>
<li><strong>200 OK</strong></li>
</ul>
<h3>3 强制用户登录</h3>
<h3 id="-38">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorization</td>
<td></td>
<td>是</td>
<td>Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NDMyODQzNjYsInVzZXJfaWQiOjF9.mLYitrKsn4E4KdQd0CNPugKrH8uQmXEQTlG_JutC8jU</td>
<td>用户令牌token，必传</td>
</tr>
</tbody>
</table>
<h3 id="-39">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户id	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户名	</span></td><td key="5"></td></tr><tr key="0-1-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户头像	</span></td><td key="5"></td></tr><tr key="0-1-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> is_media</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">是否是自媒体，0-否，1-是	</span></td><td key="5"></td></tr><tr key="0-1-4"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> intro</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">简介	</span></td><td key="5"></td></tr><tr key="0-1-5"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> certi</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">自媒体认证说明	</span></td><td key="5"></td></tr><tr key="0-1-6"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> art_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">发布文章数	</span></td><td key="5"></td></tr><tr key="0-1-7"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> follow_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">关注的数目	</span></td><td key="5"></td></tr><tr key="0-1-8"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> fans_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">fans_count</span></td><td key="5"></td></tr><tr key="0-1-9"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> like_count</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">被点赞数	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h1 id="u9891u9053">频道</h1>
<p></p>
<h2 id="u83b7u53d6u6240u6709u9891u9053u5217u88680a3ca20id3du83b7u53d6u6240u6709u9891u9053u5217u88683e203ca3e">获取所有频道列表
<a id="获取所有频道列表"> </a></h2>
<p></p>
<h3 id="-40">基本信息</h3>
<p><strong>Path：</strong> /v1_0/channels</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<ul>
<li>1 线上地址</li>
</ul>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/channels
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>507 数据库错误</li>
<li><strong>200 OK</strong></li>
</ul>
<h3 id="-41">请求参数</h3>
<h3 id="-42">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> channels</span></td><td key="1"><span>object []</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">选项词条	</span></td><td key="5"><p key="3"><span style="font-weight: &#39;700&#39;">item 类型: </span><span>object</span></p></td></tr><tr key="0-1-0-0"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">频道id	</span></td><td key="5"></td></tr><tr key="0-1-0-1"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">频道名称	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h1 id="u8bc4u8bba">评论</h1>
<p></p>
<h2 id="u83b7u53d6u8bc4u8bbau6216u8bc4u8bbau56deu590d0a3ca20id3du83b7u53d6u8bc4u8bbau6216u8bc4u8bbau56deu590d3e203ca3e">获取评论或评论回复
<a id="获取评论或评论回复"> </a></h2>
<p></p>
<h3 id="-43">基本信息</h3>
<p><strong>Path：</strong> /v1_0/comments</p>
<p><strong>Method：</strong> GET</p>
<p><strong>接口描述：</strong></p>
<ul>
<li>1 线上地址</li>
</ul>
<pre><code data-language="url" class="lang-url">http://localhost:8000/v1_0/comments
</code></pre>
<h3>2 返回状态码</h3>
<ul>
<li>400 请求参数错误</li>
<li>507 数据库错误</li>
<li><strong>200 OK</strong></li>
</ul>
<h3 id="-44">请求参数</h3>
<p><strong>Query</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>a或c</td>
<td>评论类型，a-对文章(article)的评论，c-对评论(comment)的回复<br></td>
</tr>
<tr>
<td>source</td>
<td>是</td>
<td></td>
<td>源id，文章id或评论id<br></td>
</tr>
<tr>
<td>offset</td>
<td>否</td>
<td></td>
<td>获取评论数据的偏移量，值为评论id，表示从此id的数据向后取，不传表示从第一页开始读取数据<br></td>
</tr>
<tr>
<td>limit</td>
<td>否</td>
<td></td>
<td>获取的评论数据个数，不传表示采用后端服务设定的默认每页数据量<br></td>
</tr>
</tbody>
</table>
<h3 id="-45">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> message</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">提示信息	</span></td><td key="5"></td></tr><tr key="0-1"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-1-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> total_count</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">该文章的评论总数 或 该评论的回复总数	</span></td><td key="5"></td></tr><tr key="0-1-1"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> end_id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">所有评论或回复的最后一个id（截止offset值，小于此值的offset可以不用发送请求获取评论数据，已经没有数据），若无评论或回复数据，则值为NULL	</span></td><td key="5"></td></tr><tr key="0-1-2"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> last_id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">本次返回结果的最后一个评论id，作为请求下一页数据的offset参数，若本次无具体数据，则值为NULL	</span></td><td key="5"></td></tr><tr key="0-1-3"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> results</span></td><td key="1"><span>object []</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">评论或回复的内容	</span></td><td key="5"><p key="3"><span style="font-weight: &#39;700&#39;">item 类型: </span><span>object</span></p></td></tr><tr key="0-1-3-0"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> com_id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">评论或回复id	</span></td><td key="5"></td></tr><tr key="0-1-3-1"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> aut_id</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">评论或回复的用户id	</span></td><td key="5"></td></tr><tr key="0-1-3-2"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> aut_name</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户名称	</span></td><td key="5"></td></tr><tr key="0-1-3-3"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> aut_photo</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">用户头像url	</span></td><td key="5"></td></tr><tr key="0-1-3-4"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> like_count</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">点赞数量	</span></td><td key="5"></td></tr><tr key="0-1-3-5"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> reply_count</span></td><td key="1"><span>integer</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">回复数量	</span></td><td key="5"></td></tr><tr key="0-1-3-6"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> pubdate</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">创建时间	</span></td><td key="5"></td></tr><tr key="0-1-3-7"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> content</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">评论或回复内容	</span></td><td key="5"></td></tr><tr key="0-1-3-8"><td key="0"><span style="padding-left: 40px"><span style="color: #8c8a8a">├─</span> is_liking</span></td><td key="1"><span>boolean</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">当前用户是否点赞	</span></td><td key="5"></td></tr>
               </tbody>
              </table>
<h1 id="u6587u4ef6">文件</h1>
<p></p>
<h2 id="u4e0au4f20u56feu72470a3ca20id3du4e0au4f20u56feu72473e203ca3e">上传图片
<a id="上传图片"> </a></h2>
<p></p>
<h3 id="-46">基本信息</h3>
<p><strong>Path：</strong> /v1_0/upload</p>
<p><strong>Method：</strong> POST</p>
<p><strong>接口描述：</strong></p>
<h3 id="-47">请求参数</h3>
<p><strong>Headers</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数值</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>multipart/form-data</td>
<td>是</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><strong>Body</strong></p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数类型</th>
<th>是否必须</th>
<th>示例</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>image</td>
<td>file</td>
<td>是</td>
<td></td>
<td>图片file</td>
</tr>
</tbody>
</table>
<h3 id="-48">返回数据</h3>
<table>
  <thead class="ant-table-thead">
    <tr>
      <th key="name">名称</th><th key="type">类型</th><th key="required">是否必须</th><th key="default">默认值</th><th key="desc">备注</th><th key="sub">其他信息</th>
    </tr>
  </thead><tbody classname="ant-table-tbody"><tr key="0-0"><td key="0"><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key="1"><span>object</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap"></span></td><td key="5"></td></tr><tr key="0-0-0"><td key="0"><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> url</span></td><td key="1"><span>string</span></td><td key="2">必须</td><td key="3"></td><td key="4"><span style="white-space: pre-wrap">上传成功的图片</span></td><td key="5"></td></tr>
               </tbody>
              </table>

            <footer class="m-footer">
              <p>Build by <a href="https://ymfe.org/">YMFE</a>.</p>
            </footer>
          </div>
        </div>
      
      
      </body></html>